home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3n / t_getprotaddr.z / t_getprotaddr
Encoding:
Text File  |  1998-10-20  |  5.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. tttt____ggggeeeettttpppprrrroooottttaaaaddddddddrrrr((((3333NNNN))))                                            tttt____ggggeeeettttpppprrrroooottttaaaaddddddddrrrr((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt______gggg_eeee_tttt_pppp_rrrr_oooo_tttt_aaaa_dddd_dddd_rrrr - get protocol-specific service information
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_ffff_dddd_eeee_ffff ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_xxxx_tttt_iiii_...._hhhh_>>>>
  14.  
  15.      _iiii_nnnn_tttt _tttt______gggg_eeee_tttt_pppp_rrrr_oooo_tttt_aaaa_dddd_dddd_rrrr_((((_iiii_nnnn_tttt _ffff_dddd_,,,,
  16.                           _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt______bbbb_iiii_nnnn_dddd _****_bbbb_oooo_uuuu_nnnn_dddd_aaaa_dddd_dddd_rrrr_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt______bbbb_iiii_nnnn_dddd _****_pppp_eeee_rrrr_rrrr_aaaa_dddd_dddd_rrrr_))))
  17.      _####_eeee_nnnn_dddd_iiii_ffff
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The _tttt______gggg_eeee_tttt_pppp_rrrr_oooo_tttt_aaaa_dddd_dddd_rrrr_((((_)))) function returns local and remote protocol addresses
  21.      currently associated with the transport endpoint specified by _ffff_dddd.  In
  22.      _bbbb_oooo_uuuu_nnnn_dddd_aaaa_dddd_dddd_rrrr and _pppp_eeee_eeee_rrrr_aaaa_dddd_dddd_rrrr the user specified _mmmm_aaaa_xxxx_llll_eeee_nnnn, which is the maximum
  23.      size of the address buffer, and _bbbb_uuuu_ffff which points to the buffer where the
  24.      address is to be placed.  On return, the _bbbb_uuuu_ffff field of _bbbb_oooo_uuuu_nnnn_dddd_aaaa_dddd_dddd_rrrr points to
  25.      the address, if any, currently bound to _ffff_dddd, and the _llll_eeee_nnnn field specifies
  26.      the length of the address.  If the transport endpoint is in the T_UNBND
  27.      state, zero is returned in the _llll_eeee_nnnn field of _bbbb_oooo_uuuu_nnnn_dddd_aaaa_dddd_dddd_rrrr.  The _bbbb_uuuu_ffff field of
  28.      _pppp_eeee_eeee_rrrr_aaaa_dddd_dddd_rrrr points to the address, if any, currently connected to _ffff_dddd, and
  29.      the _llll_eeee_nnnn field specifies the length of the address.  If the transport
  30.      endpoint is not in the T_DATAXFER state, zero is returned in the _llll_eeee_nnnn
  31.      field of _pppp_eeee_eeee_rrrr_aaaa_dddd_dddd_rrrr.
  32.  
  33.      This function resides within the X/Open compliant _llll_iiii_bbbb_xxxx_nnnn_eeee_tttt Network
  34.      Services library.  Network Services applications which require X/Open
  35.      compliance must link-load with _----_llll_xxxx_nnnn_eeee_tttt.
  36.  
  37.      On failure, _tttt______eeee_rrrr_rrrr_nnnn_oooo may be set to one of the following:
  38.  
  39.      _TTTT_BBBB_AAAA_DDDD_FFFF          The specified file descriptor does not refer to a
  40.                     transport endpoint.
  41.  
  42.      _TTTT_BBBB_UUUU_FFFF_OOOO_VVVV_FFFF_LLLL_WWWW      The number of bytes allocated for an incoming argument
  43.                     (_mmmm_aaaa_xxxx_llll_eeee_nnnn) is greater than zero but not sufficient to store
  44.                     the value of that argument.
  45.  
  46.      _TTTT_SSSS_YYYY_SSSS_EEEE_RRRR_RRRR        A system error has occurred during execution of this
  47.                     function.  _TTTT_PPPP_RRRR_OOOO_TTTT_OOOO This error indicates that a
  48.                     communication problem has been detected between XTI and
  49.                     the transport provider for which there is no other
  50.                     suitable XTI (_tttt______eeee_rrrr_rrrr_nnnn_oooo).
  51.  
  52. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  53.      _tttt______bbbb_iiii_nnnn_dddd(3N)
  54.  
  55. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  56.      _tttt______gggg_eeee_tttt_pppp_rrrr_oooo_tttt_aaaa_dddd_dddd_rrrr returns 0 on success and -1 on failure and _tttt______eeee_rrrr_rrrr_nnnn_oooo is set
  57.      to indicate the error.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.